home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / bgfax160.zip / BGFAX.DOC < prev    next >
Text File  |  1996-06-22  |  57KB  |  1,131 lines
  1.  
  2.     =======================================================================
  3.  
  4.               Voice               B.J. Guillot           Data/Fax
  5.          +1 713.893.9320      2611 Rushwood Circle   +1 713.893.9124
  6.                             Houston Texas 77067-1941
  7.                             United States of America
  8.  
  9.           Copyright (C) 1993-1996 B.J. Guillot.  All Rights Reserved.
  10.  
  11.     FidoNet 1:106/400                        E-mail: bjg90783@jetson.uh.edu
  12.     Echo "BGFAX" on Fido Backbone             http://www.blkbox.com/~bgfax/
  13.  
  14.     =======================================================================
  15.     BGFAX 1.60                                               SAT 22 JUNE 96
  16.     =======================================================================
  17.  
  18.       "It wasn't a miracle... We just decided to go."
  19.               -- Tom Hanks, playing Jim Lovell in APOLLO 13,
  20.                  referring to the Apollo 11 moon landing.
  21.  
  22.       "...Humans and aliens wrapped in two million, five hundred
  23.       thousand tons of spinning metal, all alone in the night..."
  24.               -- Commander Sinclair.  BABYLON 5.
  25.  
  26.       "The Babylon project was our last, best hope for peace.  IT FAILED.
  27.       In the year of the Shadow War, it became something greater.
  28.       Our last, best hope for victory."
  29.               -- Commander Susan Ivanova.  BABYLON 5.
  30.  
  31.       "Let's make sure history never forgets the name: ENTERPRISE."
  32.               -- Captain Jean-Luc Picard.  Star Trek: The Next Generation.
  33.  
  34.          -------------------------------------------------------------
  35.          ABSTRACT/FEATURES
  36.          -------------------------------------------------------------
  37.  
  38.          * Can send faxes from the DOS (or OS/2) command line and return
  39.            status by errorlevel; fully configurable top of page headers
  40.  
  41.          * Allows sysops to receives faxes on their BBS telephone line
  42.            without needing any additional hardware!
  43.  
  44.          * Everything runs in the foreground, no TSR programs needed
  45.  
  46.          * If you are already running a Fido mailer, you can configure
  47.            your mailer to exit and run BGFAX when the line is hot, thus
  48.            BGFAX does not necessarily have to answer the phone itself
  49.  
  50.          * Comes with a small and quick fax viewing program that supports
  51.            CGA, EGA, VGA, and VESA SVGA display modes as well as options
  52.            for fax printing and FAX-to-PCX (and DCX) conversion; it even
  53.            can use XMS!
  54.            [ See VIEW.DOC for more information ]
  55.  
  56.          * Multitasker aware; releases ticks to OS/2, Win95, and DesqView
  57.  
  58.          -------------------------------------------------------------
  59.          OBTAINING THE LATEST VERSION OF BGFAX:
  60.          -------------------------------------------------------------
  61.  
  62.          Where can I check to find out if I have the latest version?
  63.  
  64.          (a)  http://www.blkbox.com/~bgfax
  65.  
  66.          (b)  Calling my BBS in the United States, +1 713-893-9124
  67.  
  68.          (c)  FidoNet FREQ of the magic name "BGFAX" from 1:106/400
  69.               (Beta copies are available under magic name "BGBETA")
  70.  
  71.          (d)  FidoNet FREQ...  The Netherlands...  2:512/39
  72.               The Owl's Nest is the Dutch Supra distributor and they
  73.               have three nodes:
  74.                 +31 0.2155.10921   +31 0.2155.12571   +31 0.2155.28096
  75.  
  76.          (e)  FidoNet FREQ...  Austraila...  3:632/552
  77.               Hamish Moffatt, Cloud Nine, +61 03.886.5195
  78.  
  79.    *************************************************************************
  80.    *************************************************************************
  81.  
  82.          IF YOU ARE TRYING TO RECEIVE FAXES ON YOUR BBS.....
  83.  
  84.          The *.TXT files provide step-by-step setup instructions for most
  85.          mailers and BBS software.  You probably will NOT have to read the
  86.          rest of this documentation file!
  87.  
  88.          If you spend more than 30 minutes trying to setup BGFAX then you
  89.          are doing something wrong.  The *.TXT files will provide you with
  90.          the best info for many setups.  The *.TXT files are designed so
  91.          that you can pick which one fits your configuration, print it out,
  92.          follow the instructions, and be set up in 10 minutes.
  93.  
  94.    *************************************************************************
  95.    *************************************************************************
  96.  
  97.    #########################################################################
  98.    ##                        RECEIVE FAX MODE                             ##
  99.    #########################################################################
  100.  
  101.          -------------------------------------------------------------
  102.          /HOST MODE             In this mode, BGFAX answers the phone!
  103.          -------------------------------------------------------------
  104.  
  105.          If you want BGFAX to answer the phone, BGFAX is started up using
  106.          the /HOST command line parameter.  Things to do.....
  107.  
  108.          1. Make sure the BGFAX.CNF file is in the same directory as the
  109.             BGFAX.EXE file.  If it is not, you will need to use the BGFAX
  110.             "environment variable" to point to the directory that the CNF
  111.             file stays in (i.e., "SET BGFAX=C:\BGFAX" in FBBS.BAT)
  112.  
  113.          2. Open the BGFAX.CNF configuration file with a text editor
  114.             (such as QEdit, DOS's EDIT.EXE, PC Magazine's TED.COM), and
  115.             make any changes you see fit.  The important thing to do is
  116.             make sure the right com port is set.  For many people, this
  117.             is the only thing that needs to be changed.  The BGFAX.CNF
  118.             file defaults to using a standard Class 2 adaptive answering
  119.             configuration.  If you are using a US Robotics (Class 2.0)
  120.             or Hayes (Class 1) modem, you will need to "uncomment" the
  121.             lines for your modem, and then "comment out" the lines for
  122.             the default Class 2 configuration.  My recommendation: PRINT
  123.             OUT A COPY OF THE BGFAX.CNF FILE AND STUDY IT FOR A FEW
  124.             MINUTES!  THIS WILL HELP YOU IN THE LONG RUN!
  125.  
  126.          3. BGFAX can exit with five possible errorlevels in /HOST mode
  127.  
  128.                6 - /HOST:nn mode has been idle for more than nn minutes
  129.                4 - fax was received (completely or partially)
  130.                3 - local logon
  131.                2 - data call
  132.                1 - restart the FBBS.BAT batch file
  133.  
  134.             If no errorlevel is encountered, it means the sysop aborted
  135.             BGFAX by pressing the [Esc] key or a serious error occurred.
  136.  
  137.             Actually, BGFAX can exit with several errorlevels if you setup
  138.             events.  Events are specified in the BGFAX.CNF file (see the
  139.             example file included).  Example:
  140.  
  141.             ev=07:00,192
  142.             ev=19:00,193
  143.  
  144.             That would cause BGFAX to exit with errorlevel 192 at 7:00am
  145.             and errorlevel 193 at 7:00pm.  BGFAX's event handling is very
  146.             crude, and I very much need to change it.  The event handling
  147.             still has several bugs that need to be fixed.  It works best if
  148.             you use a total of two events.  One event doesn't work very
  149.             well, and if you use more (up to 20 are allowed), you can miss
  150.             an event or two if a caller to your BBS overstays their visit.
  151.             BGFAX will always execute the first event that is passed over,
  152.             but won't do any more.  And, if you only have one event setup,
  153.             it will not execute that one if it is missed.  But it will, if
  154.             you set up two events.  You can probably tell I hate events.
  155.             If anyone has some ideas on how to keep track of events and
  156.             execute the ones that are missed, etc., I'd appreciate it.
  157.  
  158.          4. When BGFAX is waiting for a call, pressing Ctrl-R will reset
  159.             the on screen counters.  Ctrl-A will force BGFAX to send the
  160.             answer string to the modem.  (Some customers need to have BGFAX
  161.             answer the phone as soon as i